home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / psselect.z / psselect
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPSSSSSSSSEEEELLLLEEEECCCCTTTT((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       PPPPSSSSSSSSEEEELLLLEEEECCCCTTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      psselect - select pages from a PostScript file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppsssssssseeeelllleeeecccctttt [----eeee] [----oooo] [----rrrr] [----ppppppppaaaaggggeeeessss]
  13.               [----hhhh] [----DDDD] [infile] [outfile]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The _p_s_s_e_l_e_c_t program allows pages from a PostScript document to be
  17.      extracted into a new PostScript document. Pages may be selected according
  18.      to a number of criteria and the selected pages may be output in reverse
  19.      order. In order for _p_s_s_e_l_e_c_t to properly function, the input PostScript
  20.      document must conform to the Adobe Document Structuring Conventions (DSC)
  21.      revision 1.0 or higher.
  22.  
  23.      If iiiinnnnffffiiiilllleeee is not specified, _p_s_s_e_l_e_c_t will read input from the standard
  24.      input. Similarly, if oooouuuuttttffffiiiilllleeee is not specified, the program will write its
  25.      output to the standard output.
  26.  
  27.      If _p_s_s_e_l_e_c_t is specified with no options, it simply copies its standard
  28.      input to standard output.
  29.  
  30.      ----eeee        The -_e option selects only even pages for output.
  31.  
  32.      ----oooo        The -_o option selects only odd pages for output.
  33.  
  34.      ----pppp_p_a_g_e_s   The -_p option specifies which page numbers are to be output.
  35.                _p_a_g_e_s is a comma separated list of page number ranges. A page
  36.                range has the form _f_i_r_s_t-_l_a_s_t. The following examples
  37.                demonstrate how various page ranges may be specified:
  38.  
  39.  
  40.                -p1-5     Select pages 1 thru 5 inclusive
  41.                -p1,5,3   Select pages 1, 3 and 5
  42.                -p-5      Select pages 1 through 5
  43.                -p5-      Select pages 5 thru the end of the document
  44.  
  45.                Note that there is no space between the switch and its
  46.                argument.
  47.  
  48.      ----rrrr        Specifies that the selected pages should be output in reverse
  49.                order.
  50.  
  51.      ----hhhh        Prints a program usage message to the standard error. This
  52.                usage message also lists the currently supported output
  53.                configurations.
  54.  
  55.      ----DDDD        Specifies verbose output for debugging purposes.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPSSSSSSSSEEEELLLLEEEECCCCTTTT((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       PPPPSSSSSSSSEEEELLLLEEEECCCCTTTT((((1111))))
  71.  
  72.  
  73.  
  74. NOTES
  75.      1.   _p_s_s_e_l_e_c_t selects pages in the order that they appear in the input
  76.           file.  The program assumes that the first page encountered is page
  77.           one. This may differ from the actual page ordering of the document.
  78.  
  79.      2.   The ----eeee, ----oooo, and ----pppp switches may be used in combination.  For
  80.           example, specifying the switch ----pppp2222----7777 and ----eeee will select all even
  81.           numbered pages between two and seven (i.e. 2, 4, and 6). If both the
  82.           ----eeee and ----oooo switches are specified, all pages within the specified
  83.           page range will be selected.
  84.  
  85.      3.   If _p_s_s_e_l_e_c_t is given an unrecognized or incomplete command line
  86.           option switch, it will print a warning message to the standard
  87.           error, ignore the option and continue processing.
  88.  
  89.      4.   Certain processing options require that _p_s_s_e_l_e_c_t create a temporary
  90.           copy of the input file.  This temporary file will be created in the
  91.           directory specified by the TTTTMMMMPPPPDDDDIIIIRRRR environment variable. If that
  92.           variable is not set, the temporary file will be created in /_v_a_r/_t_m_p.
  93.           There must be sufficient free space in the temporary file directory
  94.           to store a complete copy of the input file or _p_s_s_e_l_e_c_t will fail.
  95.  
  96. TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  97.      PostScript is a trademark of Adobe Systems, Inc.
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l - 2nd ed., Adobe Systems, Inc.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.